Cream of the Crop 12

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 12 / Cream of the Crop 12 (Part II) / Cream of the Crop 12 (Part II).iso / BBS / VFY_39.ZIP / 4-TRIBBS.ZIP / TRISEC.DOC < prev next >

Wrap

Text File | 1995-12-26 | 12.5 KB | 321 lines

************************************************************** * * * TRISEC.EXE v10.4 * * * * TRIBBS User Security Level Adjustment Program * * * * Copyright (c) 1993/95 * * Sagerquist Micro Engineering * * * * 1414 W. Kerrick Street * * Lancaster, Ca. 93534 * * Data (805) 723-6908 * * * ************************************************************** DESCRIPTION ----------- TRISEC.EXE adjusts a TRIBBS caller's security level in the TRIBBS user database file USERS.DAT. This action is useful when invoking BBS Doors such as a Call Back Verification, a Questionnaire or Opinion Poll, etc., where the caller is to be rewarded with a security level adjustment upon successful completion. The caller's remaining time may also be altered. SYNTAX ------ TRISEC [/S:(New Security Level)] [/D:(Node Directory (location of SYSDAT2.DAT - optional)] [/T=:[(New Remaining Time in Minutes)] <Registered only> [/T+:[(Minutes to Add to Remaining Time] <Registered only> Note: Either Security, Remaining Time or both may be adjusted. The Security value is an optional value. Note: Only one /T switch is allowed. Note: /D:... switch is optional. It will override the default value: C:\TRIBBS. If your TriBBS system is set up on a different drive or directory, use the command line switch to override the default values. EXAMPLES -------- TRISEC /S:100 /T+:30 TRISEC /T+:60 TRISEC /D:F:\TRIBBS /S:100 TRISEC /D:D:\TRIBBS /S:100 /T+:30 TRISEC ? SAMPLE TRAP DOOR BATCH FILE --------------------------- Note: TRIBBS places the callers logged actions into the file CALLERS.LOG in the NWORK directory. When the caller hangs up, all the information is written (appended) to the file CALLERS.LOG in the MWORK directory. The CALLERS.LOG in the MWORK directory is the permanent log. If VERIFY!.EXE is going to log its action in CALLERS.LOG, be sure to specify the CALLERS.LOG file in the NWORK directory with the /L: switch. Note: The DOORS.MNU entry would look like this: T,Call Back Verification,VERIFY!,10 @ECHO OFF ECHO ******* Entering VERIFY! *******>> C:\TRIBBS\NWORK\CALLERS.LOG C: CD C:\TRIBBS\VERIFY! VERIFY! /B:TRIBBS /D:C:\TRIBBS /L:C:\TRIBBS\NWORK\CALLERS.LOG rem ERRORLEVEL 0 and 1 means caller is verified. rem ERRORLEVEL 0 == local call rem ERRORLEVEL 1 == long distance IF ERRORLEVEL 0 IF NOT ERRORLEVEL 2 goto ADJUST goto END :ADJUST rem Adjust caller's security level to 50 C:\TRIBBS\SME_UTLS\TRISEC /S:50 /T=:90 :END CD C:\TRIBBS BOARD TECHNICAL --------- TRISEC.EXE was designed to compliment VERIFY!.EXE, a BBS Call Back Verify program, and both were originally intended for use in a DOOR. When a TriBBS DOOR launches, TriBBS creates DOORS.TMP. It contains the caller's information. If values are changed in this file, the data in TriBBS's databases are automatically updated. TRISEC.EXE will change the data in DOORS.TMP to accomplish its goals. TRISEC.EXE begins by reading the file SYSDAT2.DAT for the node in operation. From there, all other system files can be found. Then the file DOORS.TMP is read, where the User Record Number is retrieved. The caller's record in the file USERS.DAT is updated with the new security level. If the security level update is successful, the file DOORS.TMP is updated with the remaining time value (if defined). DOOR.SYS is then deleted, since values there will override changes to USERS.DAT. SHARE.EXE: All files are opened in SHARE mode, allowing other applications to access the files. The current user's record in USERS.DAT is "locked" prior to changing any values which ensures other applications cannot crash the system by trying to alter the same area of the file. SHARE.EXE must be loaded for TRISEC to operate on a multitasking system (multiple nodes). Without SHARE.EXE on a multinode system, it is highly likely that TRISEC will fail when accessing USERS.DAT. TRISEC will operate without SHARE.EXE on a single node system. If DOOR.SYS exists, TRISEC will delete it. Otherwise, the values in DOOR.SYS will override the changes made to DOORS.TMP and USERS.DAT. On exit of TRISEC, ERRORLEVELs are returned. Your batch file can check the ERRORLEVEL and determine what has happened. The following is a list of TRISEC's ERRORLEVELs and their meaning: ERRORLEVEL 0 Normal exit, adjustment successful. ERRORLEVEL 1 Error exit, either a file cannot be found, the adjustment cannot be made, the user's name cannot be found, etc. The actual reason for the error is written to the screen. Review your DOS manual for more information on ERRORLEVELs. REGISTRATION ------------ This program is part of "The SME TriBBS Utilities Package" which are released as Shareware. You are granted a 30 day limited license for evaluation purposes. If you decide to continue its use, registration is required. The time adjustment function (from the /T+: and /T=: command line switches) is disabled until registration. Registration is for the entire package. Every program in the package will operate on the same registration number. This number is generated from the BBS's sysop name. The name entered on the registration form must be the BBS's sysop name. The registration fee is $20.00. California residents please add 8.25% sales tax of $1.65, total: $21.65 If the SME TriBBS Utility Package is purchased with or after VERIFY!.EXE BBS Call Back Verifier, registration is only $10.00. California residents please add 8.25% sales tax of $0.83. Please print and fill out the file REGISTER.FRM, and send a check or money order to: Sagerquist Micro Engineering 1414 W. Kerrick St. Lancaster, CA 93534 If you have any suggestions for improvement, or requests for other utilities to add to this package, please contact Carl Sagerquist through The SME Support BBS, or via mail. Thank you for your support! PROGRAMMING SERVICES ==================== TRISEC.EXE is a custom program, and performs exactly as requested. Programming services are provided by Sagerquist Micro Engineering by request. The points of contact are: The SME Support BBS ----------> (805) 723-6908 28800 Baud Internet E-Mail --------------> zs@qnet.com Internet World Wide Web Page--> http://www.av.qnet.com/~zs/ Post Office "Snail Mail": Sagerquist Micro Engineering 1414 W. Kerrick St. Lancaster, CA 93534 If you have an idea for a program of any kind, please call! DISCLAIMER ---------- This program is distributed as is. No warranty, either expressed or implied is offered and the programmer is not responsible for any damages or expenses that may occur through the use of this program. The user shall determine its suitability. Extensive testing has been performed and every effort has been made to ensure satisfactory performance prior to release. Please communicate any difficulties with the programmer through one of the contacts listed above. Any problems received will be treated as a top priority. CREDITS ------- Thanks to James Mann of Littlerock, CA for requesting this program, and testing it online. Thanks to Robert Massman of Dallas TX for his assistance and testing of this program on his TRIBBS system. Thanks to Rick Bretz of Columbus, OH for finding the error in version 1.2. The caller's alias was part of the check, and apparently the caller's alias is not always included in the file TRIBBS.SYS. Now, the caller's name and password is compared rather than the caller's name and alias. Thanks to John Knopf of Collierville, TN for his efforts with TRIBBS v5.01 and TRISEC.EXE. Thanks to Doug Torneden of Irving, TX for suggesting the additional time function of this program, and for testing it online. Thanks to Rick Bretz of Columbus, OH again, for his thorough work, testing and communication in his setup of VERIFY!.EXE with TRISEC.EXE. The work helped me understand the known difficulty mentioned above much more thorough. Setup suggestion is more reliable. Thanks to Mark Goodwin, author of TriBBS for releasing the source code to the TriBBS database files, and for his assistance with all my pestering questions and suggestions. Extreme thanks to Dan Harvey of New Market, TN, (BBS (614) 932-1490) for his diligence in testing TRISEC.EXE on his multinode BBS. Without his fine, exacting and detailed error reporting, TRISEC would not have been fully operational on multinode BBSs in multitasking environments. TRIBBS is copyrighted software by Mark Goodwin, 366 14th St., Bangor, ME 04401 BBS (207) 941-0805. HISTORY ------- 10/25/95 v10.4 Command line switches reduced and TriBBS system files located through SYSDAT2.DAT. /U: and /TMP: command line switches deleted. /D: switch now points to the directory location of SYSDAT2.DAT, and TRISEC.EXE locates all other necessary files through the directory structure created on initial setup, or by TRIMAN.EXE when setting up a new node. 10/21/95 v10.3 Altered file access: Shared opening of files now allows other applications to access all files TRISEC accesses. The current user record within USERS.DAT is "locked" prior to writing any changes. Also, if SHARE.EXE is not loaded, TRISEC will still attempt to make the changes. This keeps TRISEC compatible with non-multitasking systems where SHARE.EXE is not loaded. Fixed problem when TRISEC was called for nodes 2 and above, it would respond as not registered, disabling time adjustments. 10/21/95 v10.2 TriSEC, (again) has been placed within The TriBBS Utility Package requiring registration. 10/21/95 v10.1 Since the values in DOOR.SYS will override any changes made to DOORS.TMP and USERS.DAT, TRISEC.EXE now deletes DOOR.SYS if it exists. The Security value is now optional. Time only may now be adjusted. 10/20/95 v10.0 Recoded for compatibility with TriBBS v10.0. 06/01/95 v2.1 - Recoded for efficiency and appearance. 04/21/95 v2.0 - Program operation overhauled. DOORS.TMP is read and adjusted. User record locating is more direct. DOOR.SYS is no longer required to exist. In fact, if it exists, DOOR.SYS is deleted. Program screen output is changed, showing values before and after the changes. Registration as part of the SME Utility Package removed. This program is free, included with the VERIFY!.EXE program. v1.9 - Test only, not released. 01/16/95 v1.8 - Adjusted processing of the /T=: command line switch. 10/22/94 v1.7 - TRISEC may now be called from a different directory. The registration file SMETUTLS.REG now is found within the TRISEC home directory. - Command line overhauled, time may be added or altered. 10/02/94 v1.6 - TRISEC.EXE added to the TriBBS Utilities Package. 02/18/94 v1.5 - Added code to add time (minutes) to the caller's remaining time for the current call. 12/19/93 v1.4 - Added code to also alter DOOR.SYS to be compatible with TRIBBS v5.01 and above. 08/18/93 v1.3 - The checking of the caller's alias from TRIBBS.SYS is removed. Comparison check is now only the caller's name and password from TRIBBS.SYS to USERS.DAT. 08/15/93 v1.2 - More thorough checking of the caller against the database in USERS.DAT. - Command line suggestion no longer misleading. 07/24/93 v1.1 - In version 1.0, if there were more than 256 callers in the file USERS.DAT, TRISEC's writing position would start over at the beginning of the file for record # 257. This would overwrite someone else's record, effectively placing two records for that caller into the file. FIXED! 06/05/93 v1.0 - First release.